The Find Feature

This topic presents an overview of the Find feature.

The Find feature enables you to identify and view selected records in an XForm. You can access the Find feature through the pagination bar of a control. This feature is available for grouping controls (such as Table and Groupbox) attached to a model.

The parameters available in the Find feature depend on the method of the parent control's model. In addition to defining parameters, you can customize your search according to scope and method.
The scope for a search can be set as Default, Local, or Global.

• When set as Default, the application searches the local dataset; if no matching record is found, it sends a request to the backend. This is the default scope.
• When set as Local, the application searches the local dataset only. No results display if no matching record is found.
• When set as Global, the application sends a request to the backend. If no matching record is found, it retrieves the closest possible match.
  
  By default, all methods use the Get, Next, and Previous methods to retrieve and display data. However, when the scope is set as Global, you can also use alternate methods to search for records.
  Consider the following while using the Find feature:
• The Find feature is not supported for non-Process Platform protocol layouts and non-transactional models.
• The Find feature is available only for methods that contain parameters to retrieve data.
• In the case of associated models, this feature is available only if the parent model contains a reference attribute and the associated model contains one or more parameters to retrieve data.
• You cannot edit the reference parameters used in associated models while using the Find feature. You can edit only the non-referenced parameters for an associated model.
• You can define multiple parameters for searching data. Use the xforms-onfind event exposed in the data model to customize search properties.